home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / grafik / superviewel / superviewlibrary / docs / svsupport-docs / superviewsupport.doc < prev    next >
Text File  |  1995-08-02  |  5KB  |  155 lines
  1.  
  2.   superviewsupport.library
  3.  
  4.   © 1994-95 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 6.9
  9.   Release Date : 29.07.1995
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   superviewsupport.library contains functions, which are heavily used
  15.   by the superview.library and its SVObjects, SVDrivers and SVOperators.
  16.  
  17.   superviewsupport.library helps saving diskspace by just holding this
  18.   functions for usage by the other libraries.
  19.  
  20.  
  21.   There are also functions, which just might be useful for testing
  22.   and debugging new modules or programs using superview.library.
  23.  
  24.  
  25.   superviewsupport.library is mostly independent of the other Libraries yet.
  26.   Nevertheless some of the functions also depend on other Libraries,
  27.   like e.g. SVSUP_DisplayGfxBuffer(), which does SVDriver calls.
  28.  
  29.  
  30.   Author
  31.   ~~~~~~
  32.   Andreas R. Kleinert
  33.   Grube Hohe Grethe 23
  34.   D-57074 Siegen
  35.   Germany                   Andreas_Kleinert@superview.ftn.sub.org
  36.  
  37.  
  38.   ControlPad-Switches
  39.   ~~~~~~~~~~~~~~~~~~~
  40.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  41.   ControlPad-Commands : - C2P=<OS|SV>
  42.                           ; determines, whether chunky to planar conversion
  43.                           ; is managed via the appropriate OS functions
  44.                           ; or via internal ones.
  45.                           ; Due to various problems with the OS functions
  46.                           ; "SV" is now default.
  47.                           ; Be careful when using "OS" with GfxCards,
  48.                           ; which carelessly patched graphics.library.
  49.  
  50.   History
  51.   ~~~~~~~
  52.   V6.9 (29.7.1995) :
  53.  
  54.    - as long as either PAL or NTSC is available, SVSUP_GetBestModeID()
  55.      will no longer produce IDs using DEFAULT_MONITOR (mask 0x0000FFFF).
  56.      Should help promoting PAL/NTSC to >31KHz.
  57.  
  58.   V6.8 (5.6.1995) :
  59.  
  60.    - using "C2P=OS" should again be saver now (no guarantee)
  61.    - source buffer (copy) for c2p conversion now better aligned
  62.      (was not aligned, 16 was required, now is 32 Bit aligned ;-)
  63.    - removed old "cut off last upto 7 pixels" restriction.
  64.      Seems to work now properly.
  65.    - V39: aligned width of temporary BitMap to 32, although should
  66.           be done by AllocBitMap(). Safer this way, if routines are patched.
  67.  
  68.   V6.7 (18.5.1995) :
  69.  
  70.    - new C2P routines had been buggy for "less than 256 color graphics"
  71.  
  72.   V6.6 (14.5.1995) :
  73.  
  74.    - wrote replacement for OS-dependent "chunky to planar" routines,
  75.      which is now default due to the bugs/problems of the former ones
  76.    - some functions did not handle A1 safely
  77.  
  78.   V6.5 (6.5.1995) :
  79.  
  80.    - slightly revised memory routines
  81.  
  82.   V6.4 (30.4.1995) :
  83.  
  84.    - fully recompiled with SAS/C V6.55
  85.    - now saves A1 when opened/closed
  86.    - prepared to safely handle conversion of GfxBuffers > V2
  87.      (same problem, which would have caused several obsolete versions
  88.       to produce garbage on copying V2 buffers).
  89.      Will cut the version down to the lowest supported now.
  90.  
  91.   V6.3 (4.2.1995) :
  92.  
  93.    - fixed behaviour on library open errors when initializing
  94.  
  95.   V6.2 (25.1.1995) :
  96.  
  97.    - there was a bug in the ControlPad functions for modifying and
  98.      adding: if an entry already existed it might have been allocated
  99.      less memory than needed for the new entry (1 Byte).
  100.      This caused an Enforcer-Hit claiming that 16 Bytes had been trashed.
  101.      Usually would have crashed the system.
  102.  
  103.   V6.1 (13.11.1994) :
  104.  
  105.    - added seven new functions for VIRTUAL MEMORY handling
  106.  
  107.   V5.1 (29.10.1994) :
  108.  
  109.    - added three new functions for ControlPad support,
  110.      as e.g. SVSUP_ModifyControlPad()  (-> Steve Quartly)
  111.  
  112.   V4.3 (28.09.1994) :
  113.  
  114.    - WritePixelLine8() sometimes seems to destroy the source buffer.
  115.      Fixed now by using a copy of the corresponding line content.
  116.  
  117.   V4.2 (05.09.1994) :
  118.  
  119.    - created a workaround for the same "chunky pixel" bug as this has been
  120.      done with the SVDriver-Release of superview.library 8.2
  121.      (sooner or later guru'ed, if width had not been on byte boundary)
  122.  
  123.   V4.1 (26.06.1994) :
  124.  
  125.    - added two new functions for temporary displaying of GfxBuffers
  126.      (e.g. for test-purposes) and one function for free'ing "stand-alone"
  127.      GfxBuffers, which are not related to a SVObject-Handle.
  128.    - fixed some bugs in the documentation, concerning the return values
  129.      of the OnePlane/BitPlane-functions (not boolean, but SVERR_)
  130.      and of SVSUP_AllocMemEntry()
  131.  
  132.   V3.1 (27.05.1994) :
  133.  
  134.    - added two new functions for converting ONEPLANE SV_GfxBuffers into
  135.      BITPLANE SV_GfxBuffers and vice versa. Works with upto 8 Bit.
  136.      (see SVSupport_Reference.doc)
  137.    - added two new functions for converting Screens into ONEPLANE or
  138.      BITPLANE SV_GfxBuffers. Works with upto 8 Bit.
  139.      (see SVSupport_Reference.doc)
  140.  
  141.   V2.1 (22.05.1994) :
  142.  
  143.    - added four new functions for handling new, standardized "ControlPads"
  144.      (see SVSupport_Reference.doc and ControlPad.doc)
  145.  
  146.   V1.1 (07.05.1994) :
  147.  
  148.    - first version with 13 functions yet (see SVSupport_Reference.doc)
  149.  
  150.  
  151.   Copyrights
  152.   ~~~~~~~~~~
  153.   Some of the mentioned names or products above may be copyrighted by
  154.   companies or trademarks of companies.
  155.